home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / pcblim23.zip / PCBLIM.DOC < prev    next >
Text File  |  1992-07-02  |  18KB  |  567 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.         ╓───────────────────────────────────────────────────────────╖
  9.         ║                  PCBLimit Version 2.3                     ║
  10.         ║                  ====================                     ║
  11.         ║          * A PCBoard 14.5(x) User Access Utility *        ║
  12.         ║                                                           ║
  13.         ║            Copyright (C) 1992 by David D. Casto           ║
  14.         ║                   ALL RIGHTS RESERVED                     ║
  15.         ║                                                           ║
  16.         ║                 6196  Deewood Loop East                   ║
  17.         ║                  Columbus, Ohio  43229                    ║
  18.         ║                     (614)  882-0994                       ║
  19.         ║                                                           ║
  20.         ╙───────────────────────────────────────────────────────────╜
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  PCBLimit Version 2.3  -  PCBLimit.DOC  -  USER MANUAL              Page - II
  29. -----------------------------------------------------------------------------
  30.  
  31.  
  32. Table Of Contents:
  33. =================
  34.  
  35.  
  36.         Cover Page ..........................................  I
  37.  
  38.         Table Of Contents ................................... II
  39.  
  40.         Legal Information ...................................  1
  41.  
  42.         Registration ........................................  2
  43.  
  44.         Program Description .................................  3
  45.  
  46.         Installation ........................................  4-8
  47.  
  48.         Example Batch Files .................................  4
  49.  
  50.         Command Line Options ................................  4
  51.  
  52.         Example PCBLim.cfg ..................................  5
  53.  
  54.         Example PCBLim.txt ..................................  7
  55.  
  56.         Example From PCBSetUp ...............................  8
  57.  
  58.         Example $$LogOff.bat ................................  7
  59.  
  60.         What's New ..........................................  9
  61.  
  62.         Comments ............................................  10
  63.  
  64.  
  65.  
  66.                -= Upgrading?  See What's New On Page 9. =-
  67.  
  68.  
  69.  
  70.  PCBLimit Version 2.3  -  PCBLimit.DOC  -  USER MANUAL              Page - 1
  71. -----------------------------------------------------------------------------
  72.  
  73.                          PCBLimit Version 2.3
  74.                  * A PCBoard 14.5a  User Access Utility *
  75.                    Copyright (C) 1992 by David D. Casto
  76.                         6196  Deewood Loop East
  77.                          Columbus, Ohio 43229
  78.                             (614) 882-0994
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  WARNING!!
  86.  =======
  87.  
  88.       As with all new software it is * strongly * recommended that you have
  89.  
  90.     a recent backup just in case.
  91.  
  92.  
  93.  
  94.  LEGAL:
  95.  =====
  96.  
  97.       David Casto hereby disclaims all warranties relating to this software,
  98.  
  99.      whether express or implied, including without limitation any implied
  100.  
  101.      warranties of merchantability or fitness for a particular purpose. David
  102.  
  103.      Casto will not be liable for any special, incidental, consequential,
  104.  
  105.      indirect or similar damages due to loss of data or any other reason,
  106.  
  107.      even if David Casto or an agent of David Casto has been advised of the
  108.  
  109.      possibility of such damages.  In no event shall David Casto liability
  110.  
  111.      for any damages ever exceed the price paid for the license to use
  112.  
  113.      software, regardless of the form of the claim.  The user of the
  114.  
  115.      software bears all risk as to the quality and performance of the
  116.  
  117.      software.
  118.  
  119.  
  120.       You are free to distribute this software as long as there are no
  121.  
  122.      modifications to any files in this archive.
  123.  
  124.  
  125.  
  126.  PCBLimit Version 2.3  -  PCBLimit.DOC  -  USER MANUAL              Page - 2
  127. -----------------------------------------------------------------------------
  128.  
  129.  
  130.  REGISTRATION:
  131.  ============
  132.  
  133.  
  134.       You may try PCBLimit for 30 days and if you find it easy, and 
  135.     
  136.      convenient to use, a registration of $20.00 would be appreciated.  If 
  137.     
  138.      you do not like this software enough to register it then delete it!
  139.  
  140.       Registration includes:
  141.  
  142.        1) New updates to the software available for download from Blue Light
  143.  
  144.           BBS.
  145.  
  146.        2) User support also available on Blue Light BBS.
  147.  
  148.        3) A Key file that unlocks the Caller Log, Bulletin and Quiet Mode
  149.  
  150.           features. (Downloadable from Blue Light BBS)
  151.  
  152.        4) The Key file also removes "Registered to UNREGISTERED" to
  153.  
  154.           "Registered to Your BBS".
  155.  
  156.        5) Your peace of mind knowing that you have done the right thing!
  157.  
  158.        6) Optional Author upload of the key file to your BBS.
  159.  
  160.                Blue Light BBS is located in Columbus, Ohio
  161.  
  162.                       (614) 766-9708 14400 BPS
  163.  
  164.                       (614) 766-9709 19200 BPS
  165.  
  166.      * Note: Please address all correspondence to David Casto in conference
  167.  
  168.                #99 Dave's-Place when calling Blue Light BBS.
  169.  
  170.  
  171.  PCBLimit Version 2.3  -  PCBLimit.DOC  -  USER MANUAL              Page - 3
  172. -----------------------------------------------------------------------------
  173.  
  174.  
  175.  
  176.  PROGRAM DESCRIPTION:
  177.  ===================
  178.  
  179.  
  180.  
  181.      PCBLimit is an auto login door that will allow or deny users access to
  182.  
  183.      your system between the specified times.  Great for Mail Networks, or
  184.  
  185.      even those LEECH visiting SysOps that keep your nodes busy and your
  186.  
  187.      subscribers out in the cold during the peak times.
  188.  
  189.  
  190.      Yet another use could be to force a list of users into certain doors or
  191.  
  192.      to flag files for them to download.  You could even force them into a
  193.  
  194.      certain conference. (for PCBoard 14.5a only)
  195.  
  196.  
  197.      PCBLimit will show your display file to the caller and make a
  198.  
  199.      PCBStuff.kbd to force the caller to do what you want when PCBoard
  200.  
  201.      reloads (for PCBoard 14.5a only).  Or you can use the Usernet.dat to log
  202.  
  203.      them off (will work on PCBoard 14.5a and prior).
  204.  
  205.  
  206.      The uses are unlimited with a little imagination.
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  PCBLimit Version 2.3  -  PCBLimit.DOC  -  USER MANUAL              Page - 4
  213. -----------------------------------------------------------------------------
  214.  
  215.  
  216.  INSTALLATION:
  217.  ============
  218.  
  219.  
  220.    1.) Place PCBLim.EXE in your PATH.
  221.  
  222.    2.) Put a door batch file in each node(s) directory. (PCBLIMIT)
  223.  
  224.     Examples:
  225.     --------
  226.  
  227.        Regular Door Batch File:           Shell Door Batch File:
  228.  
  229.             ECHO OFF                           ECHO OFF
  230.  
  231.             PCBLIM C:\PCB\PCBLIM1.DAT          PCBLIM C:\PCB\PCBLIM1.DAT
  232.  
  233.             BOARD                              EXIT
  234.  
  235.         Command Line Options
  236.         --------------------
  237.            PCBLimit has several command line options in order to provide
  238.         flexibility with most computer systems. Here is a list:
  239.  
  240.                 NETWORK     - Forces file sharing to be active incase you
  241.                               are using something other than SHARE to manage
  242.                               file locking.
  243.                 IRQ=n       - Lets you change the IRQ used for the com port
  244.                               specified in the bbs interface file.
  245.                               (See below for more information)
  246.                 ADDR=&Hnnnn - Lets you change the address used for the com
  247.                               port specified in the bbs interface file.
  248.                               (See below for more information)
  249.  
  250.  
  251.         When you use the IRQ or the ADDR option, you must include the other.
  252.         You can't use just the IRQ and not the ADDR, and you can't use just
  253.         the ADDR and not the IRQ. Here's a chart with the STANDARD IRQs
  254.         and addresses for the PS/2s and IBM PCs:
  255.                                 Non PS/2
  256.                 Com port       IRQ     Address
  257.                    1             4       &H3F8
  258.                    2             3       &H2F8
  259.                    3             4       &H3E8
  260.                    4             3       &H2E8
  261.                   5-8            4       &H3F8
  262.  
  263.                                 PS/2
  264.                 Com port       IRQ     Address
  265.                    1             4       &H3F8
  266.                    2             3       &H2F8
  267.                    3             3       &H3220
  268.                    4             3       &H3228
  269.                    5             3       &H4220
  270.                    6             3       &H4228
  271.                    7             3       &H5220
  272.                    8             3       &H5228
  273.  
  274.  
  275.  
  276.  PCBLimit Version 2.3  -  PCBLimit.DOC  -  USER MANUAL              Page - 5
  277. -----------------------------------------------------------------------------
  278.  
  279.    3.) Place and Edit a PCBLim(x).cfg (or any Path\FileName) file in a
  280.  
  281.        directory. Use a different FileName for each node (PCBLim1.cfg
  282.  
  283.        PCBLim2.cfg etc).
  284.  
  285.        *Must contain this format!
  286.  
  287.  
  288.     Example:
  289.     -------
  290.  
  291.     C:\PCB\PCBoard.sys         <---- Path to PCBoard.sys
  292.     Blue Light BBS             <---- Board Name
  293.     Steven                     <---- Sysop First Name
  294.     Price                      <---- Sysop Last Name
  295.                                <---- Stuff Command
  296.     C:\PCB\PCBLim.txt          <---- Path\File Name of Display File
  297.     C:\PCB\PCBLim.blt          <---- Path\File Name of BLT (or NO)
  298.     23                         <---- Max Line Length of BLT
  299.     No                         <---- Run in Quiet Mode (Y or N)
  300.     06:00                      <---- Start time Restricted
  301.     23:00                      <---- End time Restricted
  302.     3                          <---- Lines of User Names to follow
  303.     Michael Graham             <---- User Name1 (or ALL)
  304.     Steven Price               <---- User Name2
  305.     Tim Money                  <---- User Name3
  306.  
  307.  
  308.  
  309.  
  310.           In this example Tim Money could call and stay on the board between
  311.  
  312.         00:00 and 05:59, and be logged off between 06:00 and 23:59.  Keep in
  313.  
  314.         mind the times are only hour sensitive, so 06:00 and 06:59 are the
  315.  
  316.         same to PCBLimit.
  317.  
  318.           Line 1 is the Path\FileName of the PCBoard.sys file.
  319.  
  320.           Line 2 is the name of your BBS.
  321.  
  322.           Line 3 is the SysOp first name.
  323.  
  324.           Line 4 is the SysOp last name.
  325.  
  326.           Line 5 is the command to stuff into PCBoards key board buffer and
  327.  
  328.         will be exicuted when PCBoard reloads.  If left blank PCBLimit will
  329.  
  330.         use the Usernet.dat to logoff the user.  The usernet.dat option
  331.  
  332.         is compatable with PCBoard versions prior to 14.5a.
  333.  
  334.  
  335.  PCBLimit Version 2.3  -  PCBLimit.DOC  -  USER MANUAL              Page - 6
  336. -----------------------------------------------------------------------------
  337.  
  338.           Line 6 is the display Path\FileName that will be displayed to the
  339.  
  340.         caller while in the door and can contain most of PCBoards @X macros.
  341.  
  342.         If in Quiet mode and left blank PCBLimit will not display anything to
  343.  
  344.         the caller.
  345.  
  346.  
  347.           Line 7 is the BLT Path\FileName of a BLT file to display a quick
  348.  
  349.         view of PCBLimit's activity without displaying the Caller(x) log.  To
  350.  
  351.         disable this feature place NO on this line.  (You need a Registered
  352.  
  353.         Key file to unlock and use the BLT feature.)
  354.  
  355.  
  356.           Line 8 is the Maximum lines to allow your BLT to be before PCBLimit
  357.  
  358.         will delete it and start a new one.
  359.  
  360.  
  361.           Line 9 is for Quiet Mode.  Place YES on this line to run under
  362.  
  363.         Quiet mode.  Quiet Mode will NOT display anything to the caller
  364.  
  365.         except the display file if it exists.  (You need a Registered Key
  366.  
  367.         file to unlock and use the Quiet Mode feature.)
  368.  
  369.  
  370.           Line 10 is the start time for Restriction
  371.  
  372.  
  373.           Line 11 is the end time for Restriction
  374.  
  375.  
  376.           Line 12 is the number of names (lines) to follow.  PCBLimit will
  377.  
  378.         only read this many names even though there could be more in the file.
  379.  
  380.  
  381.           Line 13 is the First User Name for PCBLimit to logoff.  If you
  382.  
  383.         place ALL as the FIRST User Name PCBLimit will force all callers to
  384.  
  385.         be logged off.
  386.  
  387.  
  388.           Line 14 thru XX contain user names that you want to restrict
  389.  
  390.         access.  You may have as many User Names as you like however,
  391.  
  392.  
  393.         Line 12 must reflect how many User Names to read.
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  PCBLimit Version 2.3  -  PCBLimit.DOC  -  USER MANUAL              Page - 7
  400. -----------------------------------------------------------------------------
  401.  
  402.    4.) Place and edit a PCBLim.txt (or any Path\FileName) in a directory.
  403.  
  404.        Example:
  405.        -------
  406.  
  407. @CLS@
  408.    @X0D-----------------------------------------------------------------
  409.  
  410.                             @X0CPlease Note@X0F
  411.  
  412.             Your calling hours are from 01:00 am to 6:00 am.  This
  413.            has been implemented to allow our subscribers access
  414.            to the system during peak hours.
  415.  
  416.                              Thank You
  417.                                SysOp
  418.  
  419.    @X0D-----------------------------------------------------------------
  420.  
  421.         This is a list of all the @ subtitution codes that you may use in
  422.      your display file.
  423.  
  424.         The text inside the @'s MUST be in CAPS!
  425.  
  426.        @BYTESLEFT@             Daily download bytes left
  427.        @BYTELIMIT@             Max download K limit
  428.        @CITY@                  City/State user is from
  429.        @DATAPHONE@             Business/Data phone number
  430.        @DLBYTES@               Total bytes downloaded
  431.        @DLFILES@               Total files downloaded
  432.        @EXPDATE@               Expiration date of user
  433.        @FIRST@                 First name of caller
  434.        @FIRSTU@                First name in all upper case
  435.        @HOMEPHONE@             Home/Voice phone number
  436.        @KBLEFT@                Daily download K left
  437.        @LASTDATEON@            Last date user was on
  438.        @LASTTIMEON@            Last time user was on
  439.        @MINLEFT@               Minutes remaining
  440.        @NUMTIMESON@            Number of times a user has called
  441.        @SECURITY@              Security level
  442.        @TIMELEFT@              Minutes remaining
  443.        @UPBYTES@               Total bytes uploaded
  444.        @UPFILES@               Total files uploaded
  445.        @USER@                  User's full name
  446.        @BOARDNAME@             BBS name
  447.        @NODE@                  Node number
  448.        @SYSDATE@               Current date
  449.        @SYSTIME@               Current time
  450.  
  451.        @BEEP@                  Beep the speaker
  452.        @CLS@                   Clear the screen
  453.        @MORE@                  Display a more prompt
  454.        @WAIT@                  Display a press any key prompt
  455.  
  456.  
  457.  PCBLimit Version 2.3  -  PCBLimit.DOC  -  USER MANUAL              Page - 8
  458. -----------------------------------------------------------------------------
  459.  
  460.    6.) Set up PCBLimit in PCBSetUp.  The following example will send all
  461.  
  462.        users with a security level of 50, 52, 53, 54 into PCBLim.
  463.  
  464.  
  465.        Example from PCBSetup:
  466.        ---------------------
  467.  
  468.                               Edit DOORS File
  469.  
  470.                                        USER DOOR
  471.      Filename    Password    Sec Login SYS  SYS  Shell   Path to DOOR Files
  472.     ══════════ ═════════════ ═══ ═════ ════ ════ ═════ ══════════════════════
  473.   1) PCBLIMIT                 50   Y    N    N     Y
  474.   2) PCBLIMIT                 52   Y    N    N     Y
  475.   3) PCBLIMIT                 53   Y    N    N     Y
  476.   4) PCBLIMIT                 54   Y    N    N     Y
  477.  
  478.  
  479.  
  480.    7.) Put a $$LogOff.bat file in each nodes directory.
  481.  
  482.         Example:
  483.         -------
  484.  
  485.            if exist pcbstuff.kbd del pcbstuff.kbd
  486.  
  487.  
  488.    8.) See sample CALLER1 and PCBLim.BLT files for examples of the BLT and
  489.  
  490.        Caller features.
  491.  
  492.  
  493.    9.) Please let me know if you like PCBLimit!
  494.  
  495.  
  496.  PCBLimit Version 2.3  -  PCBLimit.DOC  -  USER MANUAL              Page - 9
  497. -----------------------------------------------------------------------------
  498.  
  499.  WHAT'S NEW:
  500.  ==========
  501.  
  502.   Version 2.3
  503.   -----------
  504.  
  505.          Added - Usernet.dat logoff for use with versions of PCBoard prior
  506.  
  507.                  14.5a.
  508.  
  509.        Changed - Removed several lines from the configuration file.  PCBLimit
  510.  
  511.                  now reads PCBoard.dat for this information.
  512.  
  513.        Changed - Quiet Mode is now truely quiet and seamless.  It now has 
  514.                  
  515.                  the look of being a part of PCBoard.  Users will not even
  516.                  
  517.                  know that they are in a door.  I removed all text displayed
  518.                  
  519.                  to the caller.  However, I added 4 periods to be displayed
  520.                  
  521.                  to the caller.  The periods resemble PCBoard while
  522.                  
  523.                  searching for new bulletins.  This will let the user know
  524.                  
  525.                  that the system is busy doing something (good for slower
  526.                  
  527.                  systems).  If your display file does not exist PCBLimit
  528.                  
  529.                  will skip it and continue.
  530.  
  531.  
  532.  
  533.  
  534.  PCBLimit Version 2.3  -  PCBLimit.DOC  -  USER MANUAL              Page - 10
  535. -----------------------------------------------------------------------------
  536.  
  537.  
  538.   COMMENTS:
  539.   ========
  540.  
  541.  
  542.         I hope you like this door and that it saves lots of headaches.
  543.  
  544.      If you like it PLEASE let me know by registering it.
  545.  
  546.  
  547.         If you have any problems installing PCBLimit or any of my
  548.  
  549.      doors/utilities SUPPORT is available on Blue Light BBS, (J)oin
  550.  
  551.      conference #99, or feel free to call me voice ( 614-882-0994 ).
  552.  
  553.  
  554.         I monitor the DOOR and UTILITY conferences on Salt Air, and the Rime
  555.         
  556.         PCBHints conference.
  557.  
  558.  
  559.       * Note:  Please address all correspondence to David Casto when calling
  560.         
  561.                Salt Air or Blue Light BBS.
  562.  
  563.  
  564.  
  565.  
  566.  
  567.